home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1998 April
/
EnigmA AMIGA RUN 26 (1998)(G.R. Edizioni)(IT)[!][issue 1998-04].iso
/
classx
/
x-dve
/
utils
/
xfaplay.doc
< prev
next >
Wrap
Text File
|
1998-03-09
|
10KB
|
209 lines
******************************************************************************
* *
* eXtra Fast Animation Shell/WB/ARexx Player *
* *
* © ClassX Development 1996, all rights reserved *
* *
* ClassX - Via Francesca 463 - I 56030 Montecalvoli (PI) *
* Tel+Fax +39 587 749206 *
* *
******************************************************************************
** Introduzione
XFAPlay e' stato sviluppato per mettere a disposizione degli utenti un mezzo
per eseguire animazioni in formato XFA.
Esso e' liberamente distribuibile solo per scopi non commerciali ed e'
soggetto alle norme che regolano la distribuzione di software nella
categoria shareware.
** Caratteristiche tecniche
XFAPlay permette di caricare ed eseguire animazioni XFA da disco o da memoria
e puo' essere utilizzato dall'utente da tre ambienti operativi diversi:
Da SHELL (o CLI), da WorkBench o da ARexx.
Per mantenere l'interfaccia utente piu' consistente possibile, i comandi a
disposizione conservano terminologia e prestazioni per tutti gli ambienti
operativi.
XFAPlay utilizza la xfa.library ed e' molto compatto (poco meno di 60kb), in
modo da lasciare piu' spazio in memoria per le animazioni.
L'interfaccia utente e' ancora in inglese per ragioni legate a tempi e costi
di sviluppo, ma risultera' cosi' elementare nell'utilizzo, che nessuno
sentira' il bisogno di una versione italiana (in caso contrario fateci sapere).
******************************************************************************
** Ambiente Operativo SHELL **
******************************************************************************
Si presuppone una minima conoscenza delle modalita' operative della SHELL
di AmigaDos per un migliore utilizzo di XFAPlay in questo ambiente.
******************************************************************************
Tramite SHELL, XFAPlay si comporta come un normale comando AmigaDos e non
mostra alcuna interfaccia grafica.
Quando XFAPlay viene eseguito senza argomenti, viene mostrata sia la versione
che il prototipo di utilizzo del comando.
es:
> XFAPlay
XFAPlay v1.04 (c) ClassX 8-11-1997
Usage: XFAPlay <filename> [Loop|AutoPause|NoWait|WBModeID|Slow|CyberGfx]
dove:
<filename> e' il nome completo dell' animazione XFA (obblibatorio).
[Loop] abilita la modalita' di esecuzione in ciclo continuo.
[AutoPause] abilita la modalita' di esecuzione con pause automatiche
[NoWait] disabilita l'attesa del click del mouse all'inizio ed alla
fine dell'animazione.
[WbModeId] forza l'utilizzo di uno schermo di esecuzione con risoluzione
compatibile con quella del WorkBench (utile per visualizzare
animazioni XFA su computers non collegati a monitor PAL).
[Slow] forza l'esecuzione dell'animazione con una velocita' dimezzata.
(funziona solo con PlayMem)
[CyberGfx] esegue l'animazione su schermi CyberGraphics. L'esecuzione
potrebbe risultare notevolmente rallentata a causa di
limitazioni intrinseche di questo standard grafico.
Ogni modificatore (parola chiave tra parentesi quadre) e' opzionale ed
abilita la funzione ad esso associata solo se specificato.
Se nessun modificatore viene specificato, la condizione di esecuzione sara':
No Loop, No AutoPause, Wait, No WbModeID
esempio di utilizzo:
> XFAPlay dh1:x-dve/xfa/prova.xfa LOOP WBMODEID
Eseguira' l'animazione "prova.xfa" in modo LOOP su uno schermo compatibile
con quello del workbench.
Volendo creare un semplice script che carichi ed esegua automaticamente piu'
animazioni, e' sufficiente creare un piccolo file con ED contenente una
lista di comandi XFAPlay.
Creando tramite ED il file "show" contenente i seguenti comandi:
XFAPlay dh1:x-dve/xfa/introduzione.xfa NOWAIT
XFAPlay dh1:x-dve/xfa/titoli.xfa NOWAIT
XFAPlay dh1:x-dve/xfa/matrimonio.xfa NOWAIT
XFAPlay dh1:x-dve/xfa/battesimo.xfa NOWAIT
XFAPlay dh1:x-dve/xfa/sigla.xfa NOWAIT
(NOWAIT e' necessario se si vuole evitare di dare lo start con il mouse per
ogni animazione)
ed eseguendolo con:
> Execute show
Si otterrebbe la visualizzazione in sequenza delle animazioni.
******************************************************************************
** Ambiente Operativo WorkBench **
******************************************************************************
Dopo aver lanciato il programma, cliccando due volte sull'icona, XFAPlay
mostra la propria interfaccia sullo schermo di WorkBench.
La prima cosa da fare per eseguire una animazione e' selezionarne il nome
tramite il bottone "Src" (Source, sorgente).
Una volta che il nome dell'animazione e' stato selezionato, esso verra'
visualizzato nel campo testo accanto al bottone "Src", indicando l'avvenuta
selezione.
In questo caso, l'animazione non e' ancora stata caricata in ram e puo' essere
eseguita solamente da disco.
Questo e' facilmente verificabile, in quanto il bottone "Play Mem" non e'
abilitato, mentre "Play Disk" lo e'.
La funzione di play da disco e' stata introdotta per facilitare il preview
di una animazione senza necessariamente doverla caricare in ram.
Il play da disco, infatti, richiede poca memoria e permette l'esecuzione di
animazioni lunghissime anche se il sistema non possiede abbastanza ram da
caricarle interamente.
Il play da disco, inoltre e' abbastanza accurato e veloce da poter essere
utilizzato effettivamente per il play o il riversamento su nastro, anche
se le animazioni in modalita' 32BitI o 16BitI probabilmente risulteranno
abbastanza "scattose" su macchine lente.
Caricando l'animazione in memoria con "Load XFA", il bottone "Play Mem"
diventa disponibile e basta cliccarlo per eseguire l'animazione.
Anche il bottone "?" diventa attivo, permettendo di ottenere informazioni
sull'animazione correntemente in memoria.
I checkbox presenti nella finestra di XFAPlay, se abilitati agiscono come
segue:
[Loop] abilita la modalita' di esecuzione in ciclo continuo.
[AutoPause] abilita la modalita' di esecuzione con pause automatiche
[NoWait] disabilita l'attesa del click del mouse all'inizio ed alla
fine dell'animazione.
[WbModeId] forza l'utilizzo di uno schermo di esecuzione con risoluzione
compatibile con quella del WorkBench (utile per visualizzare
animazioni XFA su computers non collegati a monitor PAL).
[Slow] forza l'esecuzione dell'animazione con una velocita' dimezzata.
(funziona solo con PlayMem)
[CyberGfx] esegue l'animazione su schermi CyberGraphics. L'esecuzione
potrebbe risultare notevolmente rallentata a causa di
limitazioni intrinseche di questo standard grafico.
Essi sono utilizzati completamente solo per il play da memoria; il play
da disco gestisce solamente il checkbox WbModeID.
Il bottone "Free" (libera) libera la memoria occupata dall'animazione,
rendendo ancora disponibile il bottone "Play Disk".
Si ricorda che per interrompere il play di una animazione da disco, e'
sufficiente tenete premuti i due tasti del mouse contemporaneamente.
Per le modalita' di esecuzione delle animazioni in memoria ("Play Mem")
consultare pag. 100 del manuale di X-DVE.
******************************************************************************
** Ambiente Operativo ARexx **
******************************************************************************
Come gia' accennato, XFAPlay possiede una interfaccia AREXX per poter
utilizzare animazioni in formato XFA da programmi esterni che non conoscono
tale formato ma che sono compatibili ARexx.
La porta AREXX di XFAPlay si chiama "XFAPlay" e prevede i seguenti comandi:
XFA_REQSRC <s> ;Apre il file-requester preimpostandolo con <s>
XFA_SOURCE <s> ;Imposta il campo "Src" di XFAPlay con la stringa s
XFA_LOAD ;Carica l'animazione "Src" in memoria
XFA_FREE ;Libera la memoria dall'animazione
XFA_PLAYMEM ;Esegue l'animazione da memoria (se e' presente)
XFA_PLAYDISK ;Esegue l'animazione "Src" da disco
XFA_LOOP <ON|OFF> ;Imposta il modo loop per il play delle animazioni
XFA_AUTOPAUSE <ON|OFF> ;Imposta il modo autopause per il play delle animazioni
XFA_NOWAIT <ON|OFF> ;Imposta il modo nowait per il play delle animazioni
XFA_WBMODEID <ON|OFF> ;Imposta il modo wbmodeid per il play delle animazioni
XFA_SLOW <ON|OFF> ;Imposta il modo slow per il play delle animazioni
XFA_CYBERGFX <ON|OFF> ;Imposta il modo CyberGraphics per il play delle animazioni
I comandi devono essere impartiti in MAIUSCOLO.
esempio di script AREXX:
/* script di play da memoria */
options results
address 'XFAPlay'
XFA_SOURCE "DK3:XFA/ClassX.XFA"
XFA_LOAD
XFA_AUTOPAUSE OFF
XFA_LOOP OFF
XFA_PLAYMEM
XFA_FREE
exit
/* end script */
Oppure:
/* script di play da disco */
options results
address 'XFAPlay'
XFA_SOURCE "DK3:XFA/ClassX.XFA"
XFA_PLAYDISK
exit
/* end script */
Si ricorda che l'interfaccia ARexx di XFAPlay e' abilitata solo se:
- Il server ARexx RexxMast e' stato lanciato prima di XFAPlay.
- XFAPlay e' stato lanciato da WorkBench.
******************************************************************************